ARIA: Rollen für Dokumentstruktur

Die Rollen für Dokumentstruktur in ARIA werden verwendet, um eine strukturelle Beschreibung für einen Abschnitt von Inhalten bereitzustellen.

Die ARIA-Rollen für Dokumentstruktur wurden ursprünglich als Brücke geschaffen, um unterstützenden Technologien HTML5-Elemente mitzuteilen, die in Browsern noch nicht vollständig unterstützt wurden. Einige Rollen wie presentation, toolbar und tooltip liefern Informationen über die Dokumentstruktur an unterstützende Technologien in Fällen, in denen gleichwertige native HTML-Elemente nicht existieren. Andere Rollen, einschließlich der unten aufgeführten, sind nicht notwendig, da es semantische HTML-Elemente mit denselben Bedeutungen gibt. In vielen Fällen wurden diese gleichwertigen HTML-Elemente immer unterstützt.

Warnung: Diese strukturellen Rollen haben alle semantische HTML-Äquivalente. Sie werden hier zur Vollständigkeit der Dokumentation hinzugefügt. Vorzugsweise sollten sie von den Web-Autoren nicht verwendet werden. Stattdessen sollten semantische HTML-Elemente bevorzugt werden.

Einige Rollen in der Dokumentstruktur wie suggestion haben keine HTML-Äquivalente und haben daher eine separate Dokumentation. Einige Rollen mit HTML-Äquivalenten, wie heading, haben ARIA-Attributanforderungen. Sie sind unten mit Links zu ihrer individuellen Rolledokumentation aufgeführt.

Die meisten der folgenden Rollen waren nie nötig, wurden aber zur Vollständigkeit in ARIA aufgenommen. Wir haben sie hier auch zur Vollständigkeit hinzugefügt.

Strukturrollen mit HTML-Äquivalenten

Die Strukturrollen mit HTML-Äquivalenten sind unten aufgelistet:

ARIA-Rolle & Beschreibung	HTML-Äquivalent
`associationlist` Enthält nur `associationlistitemkey`-Kinder und deren Nachbargeschwister `associationlistitemvalue`.	`<dl>`
`associationlistitemkey` Muss in einer `associationlist` enthalten sein.	`<dt>`
`associationlistitemvalue` Immer ein Geschwister, das einem `associationlistitemkey` folgt.	`<dd>`
`blockquote` Ein Abschnitt von Inhalten, der aus einer anderen Quelle zitiert wird.	`<blockquote>`
`caption` Sichtbarer Inhalt, der einen `figure`, `table`, `grid` oder `treegrid` benennt und möglicherweise beschreibt. Nur in diesen 4 Rollen zu finden. Eine Caption-ID wird allgemein durch das `aria-labelledby`-Attribut einer `figure`, `grid`, `table` oder `treegrid` referenziert. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<caption>` `<figcaption>`
`code` Ein Abschnitt, der ein Fragment von Computercode darstellt. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<code>`
`deletion` Inhalt, der als entfernt oder zur Entfernung vorgeschlagen markiert ist. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<del>`
`emphasis` Wird verwendet, um Inhalt zu betonen oder hervorzuheben, ohne jedoch Wichtigkeit zu suggerieren. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<em>`
`figure` Container für ein grafisches Dokument, Bilder, Code-Fragmente oder Beispieltexte.	`<figure>`
`heading` Eine Überschrift für einen Abschnitt der Seite. Das Attribut `aria-level` ist erforderlich, um die Verschachtelungsebene anzugeben. Siehe die `heading`-Rolle für mehr Informationen.	h1, h2, h3, h4, h5, und h6
`image` Container für eine Sammlung von Elementen, die ein Bild bilden. Synonym zur `img`-Rolle.	`<img>`
`img` Container für eine Sammlung von Elementen, die ein Bild bilden. Ein zugänglicher Name ist erforderlich. Siehe die `img`-Rolle für mehr Informationen.	`<img>`
`insertion` Inhalt, der als hinzugefügt oder zur Hinzufügung vorgeschlagen markiert ist. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<ins>`
`list` Ein Abschnitt, der `listitem`-Elemente enthält. Siehe `list`-Rolle für mehr Informationen	`<ol>` `<ul>`
`listitem` Ein einzelnes Element in einer `list` oder einem `directory`. Muss in einer `list` enthalten sein (wie `<li>`). Siehe `listitem`-Rolle für mehr Informationen.	`<li>`
`mark` Markiert oder hervorgehoben für Referenz- oder Anmerkungszwecke. Siehe `mark`-Rolle für mehr Informationen.	`<mark>`
`meter` Eine Skalarmessung innerhalb eines bekannten Bereichs oder ein Bruchwert. Zugänglicher Name erforderlich. `aria-valuenow` erforderlich. Siehe `meter`-Rolle für mehr Informationen.	`<meter>`
`paragraph` Ein Absatz von Inhalten. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<p>`
`strong` Wichtiger, ernsthafter oder dringlicher Inhalt. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<strong>`
`subscript` Ein oder mehrere tiefgestellte Zeichen. Nur verwenden, wenn das Fehlen der Rolle den Inhaltssinn ändern würde. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<sub>`
`superscript` Ein oder mehrere hochgestellte Zeichen. Nur verwenden, wenn das Fehlen der Rolle den Inhaltssinn ändern würde. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<sup>`
`term` Wort oder Satz mit optionaler entsprechender Definition. Verbotene Attribute: `aria-label` und `aria-labelledby`. Siehe `term`-Rolle für mehr Informationen.	`<dfn>`
`time` Ein gültiges Datum- oder Zeitzeichenfolgenformat, das einen bestimmten Zeitpunkt auflisten. Verbotene Attribute: `aria-label` und `aria-labelledby`.	`<time>`

Hinweis: Die Attribute aria-label und aria-labelledby sind für code, caption, deletion, emphasis, generic, insertion, mark, paragraph, presentation, none, strong, subscript, superscript, suggestion, term und time verboten und sollten nur bei interaktiven Inhalten verwendet werden.

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # document_structure_roles